home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / text / tex / dvi2lj_0_49.lha / dvi2xx.histo < prev    next >
Text File  |  1992-09-09  |  23KB  |  552 lines
  1.  
  2.                        MINIDESCRIPTION FOR DVI2XX
  3.  
  4. This is a description of a dvi converter (dvi= TeX's device independent
  5. output format) that runs on PCs (XTs, ATs or compatible) under MS/DOS.
  6. DVI2XX is able to produce either device dependent code for the
  7. HP-LaserJet+ or for the IBM3812 (model 1) depending on a preproscessor
  8. switch at compile time.  The documentation concerning compile switches
  9. is located in the source.
  10.  
  11. DVI2XX can be called with the following options:
  12.  
  13.    -aXXX    directory to take fonts from
  14.    -b       take paper for first page from alternate cassette (only 3812)
  15.    -eXXX    output file: either drive:path\name of outputfile
  16.                          or device (such as lpt1, nul etc)
  17.             (default is drive:path\name of dvi file and extentsion
  18.             '.lj' for laserjet and '.pmp' for 3812)
  19.    -hXXX    headerfile to be copied before translation of dvi-file
  20.             (you can send arbitrary commands to the laserprinter)
  21.    -fXXX    print from begin of page xxx
  22.    -tXXX    print to end of page xxx
  23.    -mXXX    magnification
  24.    -xXXX    global x-offset in mm on output page
  25.    -yXXX    global y-offset in mm on output page
  26.    -r       toggle reverse/not reverse order for output
  27.             (default reverse=FALSE for 3812, reverse=TRUE for LJ)
  28.    -p       turn off font preload
  29.    -q       quiet operation
  30.    -w       no warnings
  31.  
  32. If no arguments are specifyed a short help file is displayed.
  33.  
  34. Two 'special' commands are implemented for the 3812:
  35.  
  36.    \special{file=drive:path/name}
  37.             copy specified file to the printer;
  38.             either vector- or bitmap-graphics PMP commands
  39.  
  40.    \special{orientation=Value}
  41.             set page orientation to 0, 1, 2, 3;
  42.             rotate following output to landscape mode etc.
  43.             Depending on print direction!
  44.  
  45. With the file= special TeX command I have faked the signature of
  46. my boss with nice thick ink. It is simply the pmp command for a
  47. polygon drawing and it looks surprisingly natural.
  48.  
  49. The program part for redirection of the output to the printer without
  50. intermediate spool file was relatively tricky and uses a IOCTL bios-call.
  51. The performance of the program is about 6 to 7 seconds per page on a
  52. AT with 8Mhz in the 3812 mode. It is running on our configuration
  53. via PC-NET.
  54.  
  55. Currently two font formats are supported: PXL 1001 and PXL 1002.
  56.  
  57. The program assumes the following pixelfile structure (the characters
  58. under quotes are mandatory):
  59.  
  60.     someroot
  61.        ...
  62.        "pxl"1500
  63.           amr10.pxl
  64.           cmr10.pxl
  65.           ...
  66.        "pxl"1643
  67.           amr10.pxl
  68.           cmr10.pxl
  69.           ...
  70.        ...
  71.  
  72. 300dpi files can be used with an adequate magnification (-m#1250 option).
  73.  
  74. The following characters (all of them occur in the program)  might be
  75. translated wrongly by the ASCII-EBCDIC-ASCII conversion during uploading
  76. and downloading respectively:
  77.  
  78. !  exclamation point
  79. [  left square bracket
  80. \  left slash (backslash)
  81. ]  right square bracket
  82. {  left curly bracket
  83. |  vertical bar
  84. }  right curly bracket
  85.  
  86. If the characters in the first column do not correspond to their verbal
  87. description fix the C-program adequately.
  88.  
  89. The program can be compiled with microsoft C Rel.3 or later using the
  90. -AL compiler option. If you have no adequate C-compiler at your site I can
  91. send also the compiled code via e-mail. If you have troubles with downloading
  92. please send me a floppy.
  93.  
  94. On troubles please read first comments ot the begin of the source
  95. program. Otherwise contact me.
  96.  
  97. - Gustaf Neumann
  98.   Wirtschaftsuniversitaet Wien
  99.   Institut fuer Informationsverabeitung und Informationswirtschaft
  100.   A-1090 Vienna
  101.   Augasse 2-6
  102.   Austria (Europe)
  103.  
  104. EARN/BITNET: NEUMANN at AWIWUW11
  105. ARPA: neumann%awiwuw11.bitnet@wiscvm.ARPA
  106. =========================================================================
  107. Date: 25 August 1987, 16:58:19 WUT
  108. From: NEUMANN  at AWIWUW11
  109. Subject: New release (0.30) of dvi2xx
  110.  
  111. Hi (potential) dvi2xx-user...
  112.  
  113. There is a new relase (0.30) of the dvi/3812 and dvi/HPLJ+
  114. converter. The new release features in the following points:
  115.  
  116. - it accepts the new PK 89 format (Rokicki, Tugboat Vol 6, 1985, No. 3)
  117.   that uses much less disk storage (about 1/4th of PXL1001 files),
  118. - it is possible to specify a 'string of paths' to be searched for the
  119.   PXL- or PK-files; the paths are separated by semicolons,
  120. - it accepts as file-extension either '.pxl' or '.pk',
  121. - the formats of the pixel-files (PXL-1001, PXL-1002, PK-89)
  122.   can be arbitrarily mixed;
  123.   eg. CMR10 can be in PXL-1002 format, CMINCH can be in PK-89,
  124. - the amount of storage in the PC is reduced especially when
  125.   PK-files are used,
  126. - an unimportant bug from the timing measurements has been removed,
  127. - verbatim mode can be set via commandline option -v, that informs
  128.   the user, which fonts are loaded.
  129.  
  130. We are using the driver here in the following setup.
  131. We have a print-server (IBM PC-AT) that is connected on one side with
  132. the 3812 via 19200/asynchronous port, and on the other side with a bunch
  133. of PC-ATs via IBM PC-Net. We use PC-TeX on the ATs. Historically
  134. all of the PXL-files  have been on the print-server in 1002-format
  135. being accessed from the dvi-driver over the network.
  136.  
  137. In the new setup, each of the PCs has a small set of the most used
  138. PK-fonts. By specifying with the commandline option of dvi2xx
  139. '-aLOCALFONTS;SERVERFONTS' where LOCALFONTS and SERVERFONTS are valid
  140. fontdirectories, each font is searched first in LOCALFONTS
  141. and if it is not found there in SERVERFONTS. Only seldomly used fonts
  142. are accessed via PC-NET. The network load was reduced in this way
  143. drastically, the speed improvement is about 30%.
  144.  
  145. If you have interest to receive the new version, please send a short
  146. note ....
  147.  
  148. -gustaf
  149. =========================================================================
  150. Date: 12 November 1987, 12:11:00 WUT
  151. From: NEUMANN  at AWIWUW11
  152. Subject: New release (0.31) of dvi2xx .. supports also new dir-structure
  153.  
  154. The newer versions of PCTeX (and some TeX-drivers) are distributed with
  155. fonts put into a different directory structure that uses in the
  156. directory names RESOLUTIONS rather than MAGNIFICATIONS.
  157.  
  158. The old directory structure standard was:
  159.  
  160.     somerootA
  161.        ...
  162.        "pxl"1500
  163.           amr10.pxl
  164.           cmr10.pxl
  165.           cminch.pk
  166.           ...
  167.        "pxl"1643
  168.           amr10.pxl
  169.           cmr10.pxl
  170.           tt10.pk
  171.           ...
  172.        ...
  173.  
  174. The new directory structure looks like:
  175.  
  176.     somerootB
  177.        ...
  178.        "DPI"300
  179.           amr10.pxl
  180.           cmr10.pxl
  181.           cminch.pk
  182.           ...
  183.        "DPI"329
  184.           amr10.pxl
  185.           cmr10.pxl
  186.           tt10.pk
  187.           ...
  188.        ...
  189.  
  190. Rel 0.31 supports both structures, it is possible to specify
  191. a path ('-a' option eg '-asomerootA;somerootB').
  192.  
  193. The search order in one directory is:
  194.    1) look for DPI....\font.pk     where '...' is eg  240
  195.    2) look for DPI....\font.pxl            or         300
  196.    3) look for pxl....\font.pk     where '...' is eg 1200
  197.    4) look for pxl....\font.pxl            or         240
  198. =========================================================================
  199. Date: 1 Dezember 1987, 14:11:00 WUT
  200.  
  201. Rel 0.32 initializes in LJ-mode the printer and resets it after run;
  202. helps when operating with the LJ2
  203. =========================================================================
  204. Date: 18 Dezember 1987, 18:18:00 WUT
  205.  
  206. Rel 0.33 runs without any modifications under Unix V (HP/UX);
  207. improved messages for missing fonts.
  208. ========================================================================
  209. Date: 5 January 1988, 04:04:04 WUT
  210. From: NEUMANN  at AWIWUW11
  211. Subject: New release (0.40) of dvi2xx
  212.  
  213. Hi everybody!
  214.  
  215. The holidays are over and there comes a new release (0.40) of DVI2XX.
  216. It has two major improvements over the previous release:
  217.  
  218. a) It supports 'HUGE' pixel characters;
  219. b) it does a better positioning which is important mainly for the 3812.
  220. c) Page origin is now on the 3812 and on the LJ2 1 inch from the left and
  221.    right edge of the paper.
  222. d) Smaller output files (== higher printing speed).
  223.  
  224. ad a)
  225.       The driver knows now about three types of characters:
  226.       -  Small characters are loaded into the font-storage of
  227.          the printer. When a small character occurs in the text,
  228.          the character is copied internally in the printer
  229.          to the output page. The bitmaps of small characters
  230.          are transmitted only once to the printer.
  231.       -  Large characters are loaded into the memory of the driver
  232.          and are transmitted on each occurance in the text as a
  233.          raster graphic to the printer.
  234.       -  Huge characters (characters which raster information has
  235.          a size more than 32767 bytes) are read on each occurance from
  236.          the disk and are transmitted as raster graphics. They are
  237.          not loaded permanently into the memory of the driver.
  238.  
  239.       Why huge Characters?
  240.       It is quite easy to include graphics into TeX by packing
  241.       bitmap graphics into TeX fonts. I've written some programs
  242.       to convert graphics generated from Drawing Gallery, Framework II,
  243.       Scanning Gallery etc. into 1001 fonts and adequate TFM files
  244.       (if you want to have more info on that send me a note).
  245.       The graphics easily reach a size of 100 or 200K each, and so
  246.       it is certainly a problem to keep these in memory.
  247.  
  248.       There are essentially 2 common ways to include graphics in TeX.
  249.       - Using \special to include printer dependent code.
  250.       - Putting the graphics into characters.
  251.  
  252.       Advantages of the latter are:
  253.       1) The reproduction of the graphics is not device dependent
  254.          (rather resolution dependent). It is possible to see
  255.          text and graphics with a good previewer together on
  256.          the screen.
  257.       2) TeX sizes the graphics as it sizes characters. It is not
  258.          necessary to include size infos about the graphics in the
  259.          TeX file. When a graphic changes its size or shape, TeX is
  260.          able to rearrange the output.
  261.  
  262.       I have scanned some photos and logos and included it in TeX
  263.       documents. It really looks great.
  264.  
  265.       Please note that a standard LJ+ has not enough memory to generate
  266.       big raster graphics.
  267.  
  268. ad b) The driver has had some problems with positioning of rules.
  269.       In heavy formula djungles very often some lines have been placed
  270.       wrong by one pixel. It is not so easy to draw lines exactly where
  271.       you want using the 3812 vector drawing facilities... Additionally
  272.       the conversion of the internal TeX units into pixels has gotten
  273.       more accurate (also for the LJ). The result is a overall better
  274.       outlook of the printed pages.
  275.  
  276. ad c) This is true at least for the European A4 paper trays.
  277.  
  278. ad d) Output has been reduced by more intelligent positioning (for
  279.       both supported printers). Additionally the driver is more clever
  280.       now in sending bitmap graphics to the LJ. The 3812-code is
  281.       reduced approximately by 25% on a 20 page document.
  282.  
  283. Caveat: the driver is a little bit slower.
  284. I hope I have not introduced to many new bugs.
  285. =========================================================================
  286. Date: 12 February 1988, 02:39:20 WUT
  287. From: NEUMANN  at AWIWUW11
  288. Subject: New release (0.41) of dvi2xx
  289.  
  290. Hi everybody!
  291.  
  292. It's time for a new release of dvi2xx. The newest version (0.41)
  293. features in the following points:
  294.  
  295.   - significantly better performance
  296.   - a bunch of new options
  297.  
  298. Performance:
  299.   The following figures are measured on a reasonably standard TeX
  300.   document (16 pages long, contains several formulas and tables)
  301.   on a PC/AT. The last two colums are also valid on Unix machines.
  302.  
  303.         time to convert dvi file  size of output file    printing speed
  304.         (times faster than 0.40)  (index rel to 0.40)    (index rel 0.40)
  305.  
  306.   3812:           2.5                    0.64                  0.70
  307.     LJ:           2.7                    0.53                  0.90
  308.  
  309.   The relative poor performance increase in printing speed for the LJ
  310.   is due to the parallel (centronics) connection in the test configura-
  311.   tion. It would increase to a similar value as for the 3812 if the
  312.   printer is connected by a serial line and communication becomes the
  313.   bottleneck.
  314.  
  315.   3 reasons are responsible for the improvements:
  316.   -  More intelligent positioning commands for setting the characters
  317.      on the page.
  318.   -  Parts of the floating point arithmetic are changed now to integer
  319.      arithmetic.
  320.   -  MSC Rel. 5 is significantly faster than MSC Rel. 4 for the large
  321.      memory model.
  322.  
  323. New options:
  324.   -c (copies): specify number of copies to print
  325.   -X define X page origin in dots
  326.   -Y define Y page origin in dots
  327.      HINT: -X and -Y allows you to set the page origin on your
  328.            printer exactly to 1in/1in from the left corner. The
  329.            provided testfile TESTPAGE.TEX helps you to figure out
  330.            where the page origin is currently set to.
  331.            (Mostly important for LJs and clones)
  332.   -g (go): print without resetting the LJ at begin of file.
  333.  
  334. Changed options:
  335.   -r option (reverse) on LJ: default changed to "print from
  336.      first page to last"
  337.   -x (set x offset relative to page origin in mm):
  338.      accepts now floating point numbers
  339.   -y (set y offset relative to page origin in mm):
  340.      accepts now floating point numbers
  341.  
  342.   NOTE that options are now case sensitive!
  343.  
  344. Other changes:
  345.   -  Warning messages are printed now to stdout instead of stderr.
  346.      It is therefore easy now to redirect it.
  347.   -  A bug in the computation of magnifications for directory names
  348.      is removed (the computed value was sometimes wrong by 1).
  349.   -  Several warning messages has been improved.
  350.  
  351. Send me a short note if you want to receive 0.41. Please indicate
  352. your favorite flavor (source/compiled, uuencode etc).
  353.  
  354. -gustaf
  355. =========================================================================
  356. Date: 22 July 1988, 03:12:20 WUT
  357. From: NEUMANN  at AWIWUW11
  358. Subject: New release (0.42) of dvi2xx
  359.  
  360. Bug fix relevant for IBM3812 AND HP LJ-family:
  361. Bug fixed that occured when last y-position of output on preceding page
  362. equals first y-position on the next page (eg: printing e 'empty' pages
  363. that have nothing but page-numbers on it).
  364.  
  365. =========================================================================
  366. Date: 26 September 1988, 22:01:12 WUT
  367. From: NEUMANN  at AWIWUW11
  368. Subject: New release (0.43) of dvi2xx
  369.  
  370. Dear user of the dvi2xx driver for the ibm3812 and the lj-family:
  371.  
  372. Rel 0.43 of dvi2xx introduces some enhancements for the lj-mode
  373. of the driver:
  374.  
  375. *  The new command line option -z causes the printer to perform a
  376.    selftest at the end of a print job. As a consequence a test page
  377.    is printed out that shows (among other useful information) the
  378.    current value of the internal page counter of the printer (might be
  379.    useful for accounting issues).
  380.  
  381. *  In rel 0.43 It is possible to print under certain circumstances
  382.    documents with more than 16 fonts on a page: The driver treats now
  383.    character glyphs of the 17th, 18th... and so on font on one page as
  384.    bitmap graphics (instead of aborting as in the earlier releases of
  385.    the program). The number of fonts per page is hence limited by the
  386.    amount of storage the printer has.
  387.  
  388.    In general it is not recommended to use more than 16 fonts per page
  389.    because after crossing this boundary each appearance of each
  390.    character in the additional fonts causes the driver to send the
  391.    bitmap of the character to the printer. As a consequence the size of
  392.    the printfile grows rapidly, the print speed goes down and (worst)
  393.    the printer runs fairly soon out of memory. If that happens firstly
  394.    the previous loaded font definitions are overwritten in the memory
  395.    of the printer and the following printout is messed up.
  396.  
  397.    However, it is possible now to print eg the Pictex manual on a LJ/2
  398.    with 1.5 meg.
  399.  
  400.    The program informs you whenever more than 16 fonts are used on a
  401.    page (unless the '-q' commandline option has been used).
  402.  
  403. -gustaf
  404. =========================================================================
  405. Date: 20 Jan 1989, 16:20:12
  406. From: NEUMANN  at AWIWUW11
  407. Subject: New release (0.44) of dvi2xx
  408.  
  409. Dear user of the dvi2xx driver for the ibm3812 and the lj-family!
  410. Rel 0.44 of dvi2xx introduces some enhancements for the lj-mode
  411. of the driver:
  412.  
  413. *  The new command line option -D causes the printer to print
  414.    in doublepage mode, that is - roughly speaking - printing first
  415.    the even pagen and then the odd pages of a document. After the
  416.    first half of the pages are printed the following happens:
  417.    o   3812: the printer beeps, shows message U1. An operator
  418.        has to refill the printed pages into the paper tray and to
  419.        push the continue button on the printer.
  420.    o   LJ-family: the printer stops, shows message "FEED" and switches
  421.        on manual feed led. The printer continues when either
  422.        the printed pages are fed into the manual page feeder,
  423.        or the operator pushes the continue button (after placing first
  424.        the printed pages into the paper tray).
  425.  
  426.    The driver allows the -D option for both print-directions (front-
  427.    to-back or back-to-front printing). It tries to be clever in certain
  428.    cases:
  429.    o   when a document has an odd number of pages it inserts in the
  430.        right place an empty page
  431.    o   when a document starts with page 0 the driver inserts an empty
  432.        page after the 0-page
  433.    o   when a piece of a document is printed that starts with
  434.        an even page-number it prints this page at the backside
  435.        of the first page to ensure that the odd sides are always
  436.        on the frontside. The 0-page is treated like an odd page.
  437.  
  438.    The doubleside option works for all LJs, not only for the
  439.    new D model with does doubleside-printing (actually, i don't
  440.    know whether it makes much sense on the new LJ II D at all).
  441.  
  442.    Caveat on the doubleside-option: When it is used frequently
  443.    or on very large files, it might become necessary to clean
  444.    the printer much more frequently.
  445.  
  446. *  The new command line option -pX can be used to abort printing
  447.    after the output of X pages (can lead to strange results together
  448.    with -D). I personally dislike this option. The secure way of
  449.    printing a part of a document is using -f (from) and -t (to).
  450.  
  451. *  graphic includes files specified for the HP-LJ-family.
  452.    Format is \special{file=DOSNAME}, where DOSNAME has
  453.    the form drive:path/name.ext.
  454.  
  455. If you want to receive the distribution please send a short note.
  456. -gustaf
  457. =========================================================================
  458. Date:         Wed, 10 May 89 22:56:30 WUT
  459. From:         Gustaf Neumann <NEUMANN@AWIWUW11>
  460. Subject:      New version (0.46) of the TeX-driver dvi2xx available
  461.  
  462. Dear user of the dvi2xx driver for the ibm3812 and the lj-family!
  463. The new release features in the following points:
  464.  
  465. General enhancements:
  466.    *  Environment variable TEXPXL is checked for the fontpath.
  467.  
  468. LJ-features:
  469.    *  Driver is now able to print closer to the paper margins.
  470.    *  \graybox-macro for lj (LaTeX Style Option) generates \fboxes with
  471.       gray-shaded background.
  472.    *  The driver is able to overcome the printer limit of 32 fonts per
  473.       document by rastering fonts a pixle maps above that limit.
  474.    *  More compact output (lj-file) to speedup printing on serial lines.
  475.  
  476. Unix-features:
  477.    *  -e- switch in the argument list redirects output to stdout. This
  478.       feature is useful especially on unix systems where the output can
  479.       be piped directly into the printer spooler.
  480.    *  Man page provided.
  481.    *  gf-support (thanks Joe Pacer); only tested for lj under unix.
  482.    *  Support for Unix TeX font naming conventions: eg <path>/cmr12.300pk
  483.  
  484. If you want to receive the new distribution please send a short note.
  485.  
  486. -gustaf neumann
  487. University of Economics and
  488. Business Administration
  489. Vienna, Austria
  490. =========================================================================
  491. Date:         Wed, 15 June 89 13:12:11WUT
  492. From:         Gustaf Neumann <NEUMANN@AWIWUW11>
  493. Subject:      New version (0.47) of the TeX-driver dvi2xx available
  494.  
  495. Dear user of the dvi2xx driver for the ibm3812 and the lj-family!
  496. The new release (0.47) features in the following points:
  497.  
  498. General enhancements:
  499.    *  Clipping of rules for 3812 and lj-family at paper edges.
  500.  
  501.       In the previous releases the
  502.         3812 ... simply refused to draw lines that left the drawable area
  503.         LJ   ... positioned the line wrongly
  504.       A new testpage.tex file shows the difference.
  505.  
  506. LJ-features:
  507.    *  new commandline option -sX to spezify pagesize
  508.         X = 1:  executive         (7.25in * 10.5in)
  509.         X = 2:  letter             (8.5in * 11in)
  510.         X = 3:  legal              (8.5in * 14in)
  511.         X = 26: A4                 (210mm * 297mm)
  512.         X = 80: monarch          (3.875in * 7.5in)
  513.         X = 81: commercial-10    (4.125in * 9.5in)
  514.         X = 90: international DL   (110mm * 220mm)
  515.         X = 91: international C5   (162mm * 229mm)
  516.       All values are from the LJ2 technical reference manual.
  517.       If the -s commandline option is omitted no clipping is performed
  518.       at the bottom of the page.
  519.  
  520. Please send a short note indicating wether you want to receive the new
  521. distribution.
  522.  
  523. -gustaf neumann
  524. University of Economics and
  525. Business Administration
  526. Vienna, Austria
  527. =========================================================================
  528. Date:         30 Oct 89 10:22:01 WUT
  529. From:         Gustaf Neumann <NEUMANN@AWIWUW11>
  530. Subject:      New version (0.48) of the TeX-driver dvi2xx available
  531.  
  532. Dear user of the dvi2xx driver for the ibm3812 and the lj-family!
  533. The new release (0.48) features in the following points:
  534.  
  535. LJ enhancements:
  536.  
  537.    *  Bug eliminated that caused the driver to generate an output
  538.       file that was much to large. The bug only showed up on
  539.       dvi files using more than 32 fonts (example: pictex manual).
  540.  
  541.    *  The new version of the driver uses a different font-id assignment
  542.       heuristic that leads in 2/3 of my test files to smaller output
  543.       files.
  544.  
  545. Please send a short note indicating wether you want to receive the new
  546. distribution (source and/or PC-binary).
  547.  
  548. -gustaf neumann
  549. University of Economics and
  550. Business Administration
  551. Vienna, Austria
  552.